home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d4 / flipper.arc / AUTOKEY.DOC < prev    next >
Text File  |  1989-08-11  |  7KB  |  166 lines
  1.  
  2. SECTION 7.0 AUTO KEY
  3.  
  4. This is the documentation file for Flipper's autokey mode.
  5.  
  6. CAUTION:
  7.  
  8. You should be very familiar with the ordinary operation of
  9. Flipper and your other software before attempting to use AUTOKEY
  10. mode.
  11.  
  12. What is AUTOKEY?
  13.  
  14. AUTOKEY is a special Flipper function which allows it to be
  15. programmed by keyboard macro programs like NEWKEY.  You can
  16. purchase NEWKEY from:
  17.  
  18. FAB Software
  19. P.O. Box 336
  20. Wayland, MA 01778
  21.  
  22. for $30.  Evaluation disks are also available for $10.  Other
  23. keyboard programs may also be used to program Flipper, but
  24. NEWKEY is highly recommended because of the niceness of the
  25. screen presentation for a blind user, and its price.  It has
  26. also been highly recommended in reviews for sighted persons.
  27.  
  28. Flipper is designed to "steal" control of the keyboard away from
  29. any other program, only returning control when it is done with
  30. each keystroke.  This makes Flipper compatible with a wide range
  31. of software which would otherwise not be usable.  For example,
  32. you can always use Flipper to access memory resident software,
  33. no matter which order it is loaded in.  This means that you can
  34. use Flipper in the ordinary way to access keyboard macro
  35. programs.  However, since Flipper ordinarily only cares about
  36. what actually is typed at the keyboard, it will ignore whatever
  37. fake keystrokes are generated by the macro program.  AUTOKEY is
  38. a special review mode which responds to these fake keystrokes.
  39. Using Flipper in the ordinary way, you can then program macro
  40. sequences using a separately purchased keyboard macro program,
  41. and access Flipper within those macros by using the autokey
  42. mode.  This allows you to both program and use macros without
  43. rebooting, or even leaving your application program.  The macros 
  44. you write can control the application program as well as Flipper,
  45. so you can write powerful macros which combine some action in the
  46. application program with Flipper reading something.
  47.  
  48. How to use AUTOKEY:
  49.  
  50. To make AUTOKEY available, you must put a capital A on the
  51. command line that starts Flipper in your autoexec file.  You
  52. must load a keyboard macro program (which you have purchased
  53. separately) before Flipper (putting the command line for the
  54. macro program before Flipper's in the autoexec file).  Repeat,
  55. the macro program must be loaded before Flipper.
  56.  
  57. After you have done this and rebooted, Flipper will have one
  58. additional command at the input level.  That command is alt a,
  59. which starts the autokey mode.  Autokey mode is like the review
  60. mode, with only a few exceptions.  You would, in general, only
  61. use autokey mode when you are programming a macro key sequence,
  62. and of course, it would be used when the macro is played back.
  63. Remember, only AUTOKEY is available within a keyboard macro, you
  64. can not program the quick keys.  The quick keys can be used to 
  65. read the screen during macro programming, however, so you can 
  66. tell where you are without messing up the macro.  Anything that
  67. you can do with the quick keys can be done with the AUTOKEY mode,
  68. and played back in a macro.
  69.  
  70. What are the differences between AUTOKEY mode and review mode?
  71.  
  72. AUTOKEY mode must be left by using the escape key.  The alt
  73. space bar can not be programmed into a macro.  There is no help
  74. mode available from within AUTOKEY mode.
  75.  
  76. What else do I need to know before using AUTOKEY?
  77.  
  78. AUTOKEY runs in two ways, interactive, and silent.  You tell
  79. Flipper which you want by using the option key alt control
  80. function key one.  When it is in interactive mode, which you
  81. would normally use to write macros, it tells you all the same
  82. things that you hear in the review mode, always reading the line
  83. or word that you are jumping to, for example.  If AUTOKEY is
  84. silent, it only reads what you specifically ask it to, for
  85. example, it won't tell you to enter a search pattern, or read a
  86. line that you jump to using the rapid motion commands (shifted
  87. or preceded by a number).  This allows you to write macros in
  88. which only what you want to be read is read.
  89.  
  90. Example using AUTOKEY:
  91.  
  92. Reading a pop up window.  If a window is popped up surrounded by
  93. a box drawn with forms characters, you can write a simple macro
  94. to read the window.  Note that some of the special keys may be
  95. captured by the keyboard macro program, for example, the control
  96. left and right square bracets in the case of newkey.  You must
  97. either turn off the macro programs use of the keys, or bypass
  98. them one at a time.  To create the macro, you would:
  99.  
  100.  
  101. start the macro recording with an alt equals
  102.  
  103. select the key to be programmed, for example, control w
  104.  
  105. press return, to give the macro no label
  106.  
  107. enter autokey with an alt a
  108.  
  109. jump to the top of the screen with a shift j, then a shift u
  110.  
  111. start a search pattern with an s.
  112.  
  113. enter a control left square bracket to search for an upper left corner.
  114.  
  115. press return to do the search.
  116.  
  117. press 1 x to mark the upper left corner.
  118.  
  119. start another search with an s.
  120.  
  121. enter a control right square bracket to search for a lower right corner.
  122.  
  123. press return to do the search.
  124.  
  125. press 2 x to mark the lower right corner
  126.  
  127. define a block by pressing d, then 5 to use block 5.
  128.  
  129. reply 1 x for the top row and left side, and 2 x for the 
  130. bottom row and the right side.
  131.  
  132. read the defined block with an alt 5.
  133.  
  134. leave the AUTOKEY mode with an escape.
  135.  
  136. After you have finished, you can read a pop up window with a
  137. control w.
  138.  
  139. You can select Flipper options from within an autokey
  140. sequence, define and read blocks, speak the time of day, and so
  141. on.  You should refer to your keyboard macro program for more
  142. advanced use of its features, and the steps needed to save your
  143. macros for later use.
  144.  
  145. If you want to send something directly to the synthesizer, for
  146. example to prompt the user or configure it in some special way,
  147. you can use the quote command.  After you press the quote key,
  148. all subsequent ascii keystrokes are sent directly to the
  149. synthesizer.  Direct output to the synthesizer is ended by any
  150. non-ascii key, such as the end key.
  151.  
  152. You can set any of the toggle options to a specific state
  153. (rather than toggling them), by using a number before the toggle.
  154. 1 chooses state 1, and 2 chooses state 2.
  155.  
  156. Another feature of Flipper which is important during Auto Key
  157. mode is the ability to use c or x in response to a request for a
  158. row or column number.  This allows you to set a block, for
  159. example, based on where you were after a search.
  160.  
  161. Note that you can enter a search pattern without immediately 
  162. searching forward for it by using shift s.
  163.  
  164.  
  165.  
  166.